Home

Introduction

Road Tracking API

version 1

Road Tracking allows determining the current position of road cargo on the World Map. To track your cargo by land, just specify the tracking number provided by the road carriers.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

Road Tracking API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://tracking.searates.com

All endpoints are only accessible via HTTPS and are located at tracking.searates.com

Get Road Shipment Tracking Information

get/road
Headers

Content-Typeapplication/json

Query Parameters
  • api_keyREQUIREDstring

    The API key required for authentication. If you do not have an API key, please contact us to purchase a subscription.

  • numberREQUIREDstring

    Tracking number of the shipment

    Example:123456789

  • carrierOptionalstring

    Carrier code

    Example:TFFT

  • typeOptionalstring

    Type of tracking (e.g., PRO)

    Example:PRO

Response example
Successfully retrieved road shipment tracking data
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "number": "990945314",
7      "carrier_code": "TFFT",
8      "type": "PRO"
9    },
10    "carrier": {
11      "name": "TForce Freight",
12      "url": "https://www.tforcefreight.com/",
13      "carrier_code": "TFFT"
14    },
15    "from_cache": false,
16    "updated_at": "2025-04-22 09:44:30",
17    "cache_expires": "2025-04-22 13:44:30"
18  },
19  "data": {
20    "status": "DELIVERED",
21    "from": {
22      "location": "irwindale",
23      "estimated_departure": null,
24      "actual_departure": null
25    },
26    "to": {
27      "location": "harshaw",
28      "estimated_arrival": null,
29      "actual_arrival": "2025-03-06 05:00:00"
30    },
31    "freight": {
32      "quantity": 1,
33      "weight": 182,
34      "cargo_units": []
35    },
36    "locations": [
37      {
38        "id": "irwindale",
39        "name": null,
40        "city": "IRWINDALE",
41        "state": "CA",
42        "country": "United States",
43        "country_code": "US",
44        "address": "CLASSIC HOME, IRWINDALE, CA, US",
45        "locode": "USIRD",
46        "lat": 34.1069527,
47        "lng": -117.9353413,
48        "timezone": "America/Los_Angeles"
49      },
50      {
51        "id": "harshaw",
52        "name": null,
53        "city": "HARSHAW",
54        "state": "WI",
55        "country": "United States",
56        "country_code": "US",
57        "address": "ROUGHING IT IN STYLE, HARSHAW, WI, US",
58        "locode": null,
59        "lat": 45.7112482,
60        "lng": -89.7185729,
61        "timezone": "America/Chicago"
62      },
63      {
64        "id": "commerce_ca",
65        "name": "COMMERCE, CA",
66        "city": "COMMERCE",
67        "state": "CA",
68        "country": "United States",
69        "country_code": "US",
70        "address": "2747 S VAIL AVE",
71        "locode": "USCRC",
72        "lat": 33.9941892,
73        "lng": -118.1300746,
74        "timezone": "America/Los_Angeles"
75      },
76      {
77        "id": "south_holland_il",
78        "name": "South Holland, IL",
79        "city": "SOUTH HOLLAND SHOP",
80        "state": "IL",
81        "country": "United States",
82        "country_code": "US",
83        "address": "17201 WESTVIEW AVE",
84        "locode": null,
85        "lat": 41.5814722,
86        "lng": -87.62846669999999,
87        "timezone": null
88      },
89      {
90        "id": "appleton_wi",
91        "name": "Appleton, WI",
92        "city": "KAUKAUNA",
93        "state": "WI",
94        "country": "United States",
95        "country_code": "US",
96        "address": "1700 TOWER DR",
97        "locode": "USKAU",
98        "lat": 44.3000559,
99        "lng": -88.26481040000002,
100        "timezone": "America/Chicago"
101      },
102      {
103        "id": "sault_ste_marie_mi",
104        "name": "Sault Ste Marie, MI",
105        "city": "KINGSFORD",
106        "state": "MI",
107        "country": "United States",
108        "country_code": "US",
109        "address": "US SPECIAL DELIVERY, 821 EAST BLVD",
110        "locode": "USKFD",
111        "lat": 45.80126692252156,
112        "lng": -88.08154904504144,
113        "timezone": "America/Menominee"
114      }
115    ],
116    "legs": [
117      {
118        "order_id": 1,
119        "status": "ARRIVED",
120        "from": {
121          "location": "irwindale",
122          "estimated_departure": null,
123          "actual_departure": null
124        },
125        "to": {
126          "location": "commerce_ca",
127          "estimated_arrival": null,
128          "actual_arrival": "2025-02-28 17:03:00"
129        },
130        "freight": {
131          "quantity": 1,
132          "weight": 182,
133          "cargo_units": []
134        },
135        "transport": {
136          "number": "255621 UPGF",
137          "type": "TRUCK"
138        },
139        "path": []
140      },
141      {
142        "order_id": 2,
143        "status": "ARRIVED",
144        "from": {
145          "location": "commerce_ca",
146          "estimated_departure": null,
147          "actual_departure": "2025-02-28 23:10:00"
148        },
149        "to": {
150          "location": "south_holland_il",
151          "estimated_arrival": null,
152          "actual_arrival": "2025-03-03 23:05:00"
153        },
154        "freight": {
155          "quantity": 1,
156          "weight": 182,
157          "cargo_units": []
158        },
159        "transport": {
160          "number": "651019 EMHU",
161          "type": "TRUCK"
162        },
163        "path": []
164      },
165      {
166        "order_id": 3,
167        "status": "ARRIVED",
168        "from": {
169          "location": "south_holland_il",
170          "estimated_departure": null,
171          "actual_departure": "2025-03-04 23:48:00"
172        },
173        "to": {
174          "location": "appleton_wi",
175          "estimated_arrival": null,
176          "actual_arrival": "2025-03-05 03:45:00"
177        },
178        "freight": {
179          "quantity": 1,
180          "weight": 182,
181          "cargo_units": []
182        },
183        "transport": {
184          "number": "511618 UPGZ",
185          "type": "TRUCK"
186        },
187        "path": []
188      },
189      {
190        "order_id": 4,
191        "status": "ARRIVED",
192        "from": {
193          "location": "appleton_wi",
194          "estimated_departure": null,
195          "actual_departure": "2025-03-05 10:00:00"
196        },
197        "to": {
198          "location": "sault_ste_marie_mi",
199          "estimated_arrival": null,
200          "actual_arrival": "2025-03-05 10:30:00"
201        },
202        "freight": {
203          "quantity": 1,
204          "weight": 182,
205          "cargo_units": []
206        },
207        "transport": {
208          "number": "570936 UPPN",
209          "type": "TRUCK"
210        },
211        "path": []
212      },
213      {
214        "order_id": 5,
215        "status": "ARRIVED",
216        "from": {
217          "location": "sault_ste_marie_mi",
218          "estimated_departure": null,
219          "actual_departure": null
220        },
221        "to": {
222          "location": "harshaw",
223          "estimated_arrival": null,
224          "actual_arrival": "2025-03-06 05:00:00"
225        },
226        "freight": {
227          "quantity": 1,
228          "weight": 182,
229          "cargo_units": []
230        },
231        "transport": {
232          "number": null,
233          "type": "TRUCK"
234        },
235        "path": []
236      }
237    ],
238    "events": [
239      {
240        "order_id": 1,
241        "event_code": "RCS",
242        "description": "Received from shipper",
243        "extended_description": "SHIPMENT HAS BEEN PICKED-UP.",
244        "date_time": {
245          "estimated": null,
246          "actual": "2025-02-28 17:03:00"
247        },
248        "location": "commerce_ca",
249        "from": {},
250        "to": {},
251        "freight": {
252          "quantity": 1,
253          "weight": 182,
254          "cargo_units": []
255        },
256        "transport": {
257          "number": "255621 UPGF",
258          "type": "TRUCK"
259        }
260      },
261      {
262        "order_id": 2,
263        "event_code": "FOH",
264        "description": "Freight on hand",
265        "extended_description": "SHIPMENT IS AT A TFORCE FREIGHT LOCATION",
266        "date_time": {
267          "estimated": null,
268          "actual": "2025-02-28 18:36:00"
269        },
270        "location": "commerce_ca",
271        "from": {},
272        "to": {},
273        "freight": {
274          "quantity": 1,
275          "weight": 182,
276          "cargo_units": []
277        },
278        "transport": {
279          "number": "255621 UPGF",
280          "type": "TRUCK"
281        }
282      },
283      {
284        "order_id": 3,
285        "event_code": "DEP",
286        "description": "Departed",
287        "extended_description": "DEPARTURE",
288        "date_time": {
289          "estimated": null,
290          "actual": "2025-02-28 23:10:00"
291        },
292        "location": "commerce_ca",
293        "from": {},
294        "to": {},
295        "freight": {
296          "quantity": 1,
297          "weight": 182,
298          "cargo_units": []
299        },
300        "transport": {
301          "number": "651019 EMHU",
302          "type": "TRUCK"
303        }
304      },
305      {
306        "order_id": 4,
307        "event_code": "ARR",
308        "description": "Arrived",
309        "extended_description": "SHIPMENT HAS ARRIVED AT A SERVICE CENTER.",
310        "date_time": {
311          "estimated": null,
312          "actual": "2025-03-03 23:05:00"
313        },
314        "location": "south_holland_il",
315        "from": {},
316        "to": {},
317        "freight": {
318          "quantity": 1,
319          "weight": 182,
320          "cargo_units": []
321        },
322        "transport": {
323          "number": "651019 EMHU",
324          "type": "TRUCK"
325        }
326      },
327      {
328        "order_id": 5,
329        "event_code": "DEP",
330        "description": "Departed",
331        "extended_description": "DEPARTURE",
332        "date_time": {
333          "estimated": null,
334          "actual": "2025-03-04 23:48:00"
335        },
336        "location": "south_holland_il",
337        "from": {},
338        "to": {},
339        "freight": {
340          "quantity": 1,
341          "weight": 182,
342          "cargo_units": []
343        },
344        "transport": {
345          "number": "511618 UPGZ",
346          "type": "TRUCK"
347        }
348      },
349      {
350        "order_id": 6,
351        "event_code": "ARR",
352        "description": "Arrived",
353        "extended_description": "SHIPMENT HAS ARRIVED AT A SERVICE CENTER.",
354        "date_time": {
355          "estimated": null,
356          "actual": "2025-03-05 03:45:00"
357        },
358        "location": "appleton_wi",
359        "from": {},
360        "to": {},
361        "freight": {
362          "quantity": 1,
363          "weight": 182,
364          "cargo_units": []
365        },
366        "transport": {
367          "number": "511618 UPGZ",
368          "type": "TRUCK"
369        }
370      },
371      {
372        "order_id": 7,
373        "event_code": "DEP",
374        "description": "Departed",
375        "extended_description": "DEPARTURE",
376        "date_time": {
377          "estimated": null,
378          "actual": "2025-03-05 10:00:00"
379        },
380        "location": "appleton_wi",
381        "from": {},
382        "to": {},
383        "freight": {
384          "quantity": 1,
385          "weight": 182,
386          "cargo_units": []
387        },
388        "transport": {
389          "number": "570936 UPPN",
390          "type": "TRUCK"
391        }
392      },
393      {
394        "order_id": 8,
395        "event_code": "ARR",
396        "description": "Arrived",
397        "extended_description": "SHIPMENT HAS ARRIVED AT A SERVICE CENTER.",
398        "date_time": {
399          "estimated": null,
400          "actual": "2025-03-05 10:30:00"
401        },
402        "location": "sault_ste_marie_mi",
403        "from": {},
404        "to": {},
405        "freight": {
406          "quantity": 1,
407          "weight": 182,
408          "cargo_units": []
409        },
410        "transport": {
411          "number": "570936 UPPN",
412          "type": "TRUCK"
413        }
414      },
415      {
416        "order_id": 9,
417        "event_code": "DLV",
418        "description": "Delivered",
419        "extended_description": "SHIPMENT HAS BEEN DELIVERED TO THE CONSIGNEE.",
420        "date_time": {
421          "estimated": null,
422          "actual": "2025-03-06 05:00:00"
423        },
424        "location": "sault_ste_marie_mi",
425        "from": {},
426        "to": {},
427        "freight": {
428          "quantity": 1,
429          "weight": 182,
430          "cargo_units": []
431        },
432        "transport": {
433          "number": "",
434          "type": "TRUCK"
435        }
436      }
437    ]
438  }
439}

Get list of supported road carriers

get/info/road_carriers
Headers

Content-Typeapplication/json

Response example
Successfully retrieved list of supported road carriers
1{
2  "status": "success",
3  "message": "OK",
4  "data": [
5    {
6      "name": "J.B.Hunt",
7      "carrier_code": "JBHT",
8      "active": true,
9      "maintenance": false,
10      "url": "https://www.jbhunt.com/",
11      "supported_number_types": [
12        "BL",
13        "DELIVERY",
14        "ORDER",
15        "PICKUP",
16        "PO",
17        "SEAL",
18        "SHIPPER",
19        "UTN"
20      ]
21    },
22    {
23      "name": "TForce Freight",
24      "carrier_code": "TFFT",
25      "active": true,
26      "maintenance": false,
27      "url": "https://www.tforcefreight.com/",
28      "supported_number_types": [
29        "PRO"
30      ]
31    }
32  ]
33}